home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / adjmsg.z / adjmsg
Encoding:
Text File  |  1998-10-30  |  3.0 KB  |  66 lines
  1.  
  2.  
  3.  
  4. aaaaddddjjjjmmmmssssgggg((((DDDD3333))))                                                          aaaaddddjjjjmmmmssssgggg((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _aaaa_dddd_jjjj_mmmm_ssss_gggg - trim bytes from a message
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _aaaa_dddd_jjjj_mmmm_ssss_gggg_((((_mmmm_bbbb_llll_kkkk______tttt _****_m_p_,,,, _iiii_nnnn_tttt _l_e_n_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _m_p        Pointer to the message to be trimmed.
  18.  
  19.      _l_e_n       The number of bytes to be removed.
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _aaaa_dddd_jjjj_mmmm_ssss_gggg removes bytes from a message.
  23.  
  24.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  25.      If the message can be trimmed successfully, 1 is returned.  Otherwise, 0
  26.      is returned.
  27.  
  28. UUUUSSSSAAAAGGGGEEEE
  29.      |_l_e_n| (the absolute value of _l_e_n) specifies how many bytes are to be
  30.      removed.  If _l_e_n is greater than _0000, bytes are removed from the head of
  31.      the message.  If _l_e_n is less than _0000, bytes are removed from the tail.
  32.      _aaaa_dddd_jjjj_mmmm_ssss_gggg fails if |_l_e_n| is greater than the number of bytes in _m_p.  If _l_e_n
  33.      spans more than one message block in the message, the messages blocks
  34.      must be the same type, or else _aaaa_dddd_jjjj_mmmm_ssss_gggg will fail.
  35.  
  36.      If _l_e_n is greater than the amount of data in a single message block, that
  37.      message block is not freed.  Rather, it is left linked in the message,
  38.      and its read and write pointers are set equal to each other, indicating
  39.      no data present in the block.
  40.  
  41.    LLLLeeeevvvveeeellll
  42.      Base or Interrupt.
  43.  
  44.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  45.      Does not sleep.
  46.  
  47.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  48.      across calls to this function.
  49.  
  50. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  51.      _mmmm_ssss_gggg_bbbb(D4)
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.